home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3 / SCSL / cgtsv.z / cgtsv
Encoding:
Text File  |  2002-10-03  |  3.8 KB  |  133 lines
  1.  
  2.  
  3.  
  4. CCCCGGGGTTTTSSSSVVVV((((3333SSSS))))                                                            CCCCGGGGTTTTSSSSVVVV((((3333SSSS))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      CGTSV - solve the equation  A*X = B,
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      SUBROUTINE CGTSV( N, NRHS, DL, D, DU, B, LDB, INFO )
  13.  
  14.          INTEGER       INFO, LDB, N, NRHS
  15.  
  16.          COMPLEX       B( LDB, * ), D( * ), DL( * ), DU( * )
  17.  
  18. IIIIMMMMPPPPLLLLEEEEMMMMEEEENNNNTTTTAAAATTTTIIIIOOOONNNN
  19.      These routines are part of the SCSL Scientific Library and can be loaded
  20.      using either the -lscs or the -lscs_mp option.  The -lscs_mp option
  21.      directs the linker to use the multi-processor version of the library.
  22.  
  23.      When linking to SCSL with -lscs or -lscs_mp, the default integer size is
  24.      4 bytes (32 bits). Another version of SCSL is available in which integers
  25.      are 8 bytes (64 bits).  This version allows the user access to larger
  26.      memory sizes and helps when porting legacy Cray codes.  It can be loaded
  27.      by using the -lscs_i8 option or the -lscs_i8_mp option. A program may use
  28.      only one of the two versions; 4-byte integer and 8-byte integer library
  29.      calls cannot be mixed.
  30.  
  31. PPPPUUUURRRRPPPPOOOOSSSSEEEE
  32.      CGTSV solves the equation A*X = B, where A is an N-by-N tridiagonal
  33.      matrix, by Gaussian elimination with partial pivoting.
  34.  
  35.      Note that the equation  A'*X = B  may be solved by interchanging the
  36.      order of the arguments DU and DL.
  37.  
  38.  
  39. AAAARRRRGGGGUUUUMMMMEEEENNNNTTTTSSSS
  40.      N       (input) INTEGER
  41.              The order of the matrix A.  N >= 0.
  42.  
  43.      NRHS    (input) INTEGER
  44.              The number of right hand sides, i.e., the number of columns of
  45.              the matrix B.  NRHS >= 0.
  46.  
  47.      DL      (input/output) COMPLEX array, dimension (N-1)
  48.              On entry, DL must contain the (n-1) subdiagonal elements of A.
  49.              On exit, DL is overwritten by the (n-2) elements of the second
  50.              superdiagonal of the upper triangular matrix U from the LU
  51.              factorization of A, in DL(1), ..., DL(n-2).
  52.  
  53.      D       (input/output) COMPLEX array, dimension (N)
  54.              On entry, D must contain the diagonal elements of A.  On exit, D
  55.              is overwritten by the n diagonal elements of U.
  56.  
  57.      DU      (input/output) COMPLEX array, dimension (N-1)
  58.              On entry, DU must contain the (n-1) superdiagonal elements of A.
  59.              On exit, DU is overwritten by the (n-1) elements of the first
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. CCCCGGGGTTTTSSSSVVVV((((3333SSSS))))                                                            CCCCGGGGTTTTSSSSVVVV((((3333SSSS))))
  71.  
  72.  
  73.  
  74.              superdiagonal of U.
  75.  
  76.      B       (input/output) COMPLEX array, dimension (LDB,NRHS)
  77.              On entry, the N-by-NRHS right hand side matrix B.  On exit, if
  78.              INFO = 0, the N-by-NRHS solution matrix X.
  79.  
  80.      LDB     (input) INTEGER
  81.              The leading dimension of the array B.  LDB >= max(1,N).
  82.  
  83.      INFO    (output) INTEGER
  84.              = 0:  successful exit
  85.              < 0:  if INFO = -i, the i-th argument had an illegal value
  86.              > 0:  if INFO = i, U(i,i) is exactly zero, and the solution has
  87.              not been computed.  The factorization has not been completed
  88.              unless i = N.
  89.  
  90. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  91.      INTRO_LAPACK(3S), INTRO_SCSL(3S)
  92.  
  93.      This man page is available only online.
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.